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1. TERMINI UND DEFINITIONEN 


Termini 
Definitionen 


Software 


Gesamtheit der für den Betrieb von EDVA, Prozeß-, 
Klein- und Mikrorechnern sowie von automatisierten 
Steuerungen, Geräten und Gerätekompiexen, Maschi- 
nen, Maschinenkomplexen und Fertigungszentren 
(Hardware) auf der Basis programmierbarer Rechner- 
baugruppen zur Verfügung stehenden Mittel in Form 
von Programmen und Dokumentationen 


"Basissoftware 
Software zur multivalenten Nutzung universeller, an- 
wenderunabhängiger gerätebezogener Prozesse 
Synonym: Systemsoftware 


Anwendersoftware 

Software für die objektkonkrete Nutzung der techni- 
schen Mittel zur Bearbeitung eines spezifischen An- 
wenderproblems 


System * 
Eine nichtleere Menge von Komponenten, zwischen 
denen solche Beziehungen bestehen, daß dadurch 
qualitative Eigenschaften entstehen, dieüberdieEigen- 
schaften der Komponenten hinausgehen 


Funktion 

Fähigkeit eines Systems, z.B. eines Programmes, eine 
bestimmte Verhaltensweise hervorzubringen, die 
durch Anforderungen definiert wird. Diese Anforde- 
rungen müssen die wesentlichen Beziehungen zwi- 
schen Eingangsgrößen, Führungsgrößen, Ausgangs- 
größen und Störgrößen zum Ausdruck bringen 


Algorithmus 

Streng logische Aufgliederung eines Problems in Ele- 
mentarschritte, wobei nach jedem Schritt der nächste 
Schritt bzw. der Abbruch der Schrittfolge eindeutig 
feststeht 


Programm 


Geordnete Menge von Befehlen/Anweisungen zur Ab- 
arbeitung eines Algorithmus auf einer Rechenanlage 


Anwenderprogramm 

Programm, das unter Steuerung eines Betriebssy- 
stems eine bestimmte Klasse von Anwendungsaufga- 
ben löst und Teil der Anwendersoftware ist 


Systemprogramm 


‚Programm, das Teilaufgaben eines Betriebssystems 
realisiert und Teil der Basissoftware ist 


Programmsystem 

Geordnete Menge von zusammenwirkenden Pro- 
grammen zur Realisierung eines Aufgabenkomplexes, 
welcher mit einem Einzelprogramm nicht lösbar ist 
Synonym: Programmkomplex ö 


Unterprogramm 


Programm, welches Bestandteil eines übergeordneten 
Programmes ist und von diesem aufgerufen wird 


Aufgabenstellung 

Anwenderbezogene Beschreibung der fachlichen Auf- 
gaben, die das Programm/Programmsystem lösen 
soll, sowie. der sonstigen Bedingungen, die das Pro- 
gramm/Programmsystem erfüllen soll 


Aufgabenlösung 


Beschreibung aller für die Realisierung der Aufgaben- 
stellung erforderlichen Komponenten und ihrer struk- 
turellen und sonstigen Beziehungen 


Installierung 


Schaffung aller Voraussetzungen, z.B. das physische 
Einbringen in den Rechner, für den betriebsbereiten 
Zustand des Programmes/Programmsystems 


Betrieb des Programmes 


Abarbeitung des Programmes/Programmsystems in 
einer durch Anforderungen definierten Umgebung 
(technische und.organisatorische Voraussetzungen) 


Anwender 


Natürliche oder juristische Person, die Software ein- 


setzt oder einsetzen will, um aus deren Einsatz Nutzen 
zu ziehen 
Synonym: Nutzer 


Systemverantwortlicher 

Person oder Instanz beim Anwender, die für die Instal- 
lierung und den Funktionstest des Programmes ver- 
antwortlich ist. Weiterhin kann der Systemverantwort- 
liche fallweise für die Klärung von Fehlern und die Be- 
ratung von fachlichen Anwendern verantwortlich sein 


Programmeinsatz 

Routinemäßige Abarbeitung eines Programmes/Pro- 
grammsystems bei einem Anwender zur Lösung kon- 
kreter Aufgaben in einer realen Umgebung 


Anwenderdokumentation 

Sammelbegriff für alle Informationen; die für den An- 
wender eines Programmes/Programmsystems erfor- 
derlich sind. 

Anmerkung: 

Die Anwendung kann in diesem Zusammenhang um- 
fassen: 

— die Entscheidung über den Einsatz 

— die Installierung 

— den rechentechnischen Betrieb 

— die fachlich orientierte Nutzung 

— die Schulung 

— die Fehlerbeseitigung, Aktualisierung 

— ‘und die Weiterentwicklung. 


Software-Anwendungssystem 

Ein rechnergestütztes System, welches zur Lösung ei- 
ner sachlich/betrieblichen Aufgabe routinemäßig ein- 
gesetzt wird und welches aus folgenden Komponen- 
ten (Teilsystemen) besteht: 
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— Programmbasis 
(eirigesetzte System- und Anwenderprogramme) 
— Datenbasis 
(gesamter genutzter bzw. erzeugter Datenfonds) 
— organisatorisches System 
(organisatorische Abläufe und ihre Reglementie- 
rungen, die für die Erfüllung der Gesamtfunktion 
notwendig sind) 
— technisches System 
(eingesetzte Gerätetechnik und ihre technischen 
Verbindungen) 


Entwicklerdokumentation 


Sammelbegriff für alle Informationen, die für den Ent- - 


wickler von Software erforderlich sind 


Teildokumentation 


Teil der Anwenderdokumentation, der unter einem be- 
stimmten Aspekt alle logisch zusammengehörigen In- 
formationen beinhaltet 

Der Aspekt kann z.B. darin bestehen, daß alle für einen 
bestimmten Teilprozeß der Anwendung benötigten In- 
formationen zusammengefaßt werden. 


2. ALLGEMEINE FORDERUNGEN 
AN DIE DOKUMENTATION 


. 2.1. Allgemeine Forderungen an die Dokumentation 
gemäß Abschnitt 3 


Eine Dokumentation entsprechend den Festlegungen 
des Abschnittes 3 dieses Standards ist anzufertigen für 
Programmsysteme, Programme oder Unterpro- 
gramme, wenn diese zur selbständigen Nutzung vor- 
gesehen sind. Im weiteren wird in der Regel nur noch 
vom „Programm“ als Oberbegriff gesprochen. 

Teile der Dokumentation brauchen nicht erstellt zu 
werden, wenn hierfür auf Dokumentationen verwiesen 
werden kann, die den Festlegungen dieses Standards 
entsprechen. 

Treffen für ein Programm bestimmte Angaben nicht 
zu, so ist unter dem entsprechenden Gliederungspunkt 
der Vermerk „Nicht zutreffend“ einzutragen. j 
Unterabschnitte (zweistellige Dezimalgliederung) der 
Teildokumentationen können zusammengefalst wer- 
den. Für Hauptgliederungspunkte (einstellige Dezimal- 
gliederung) ist dieses nicht zulässig. 

Zur Vermeidung von Wiederholungen sind Verweise 
zulässig. 


2.2. Allgemeine Forderungen an die Dokumentation 
gemäß Abschnitt 4 
Eine Dokumentation gemäß Abschnitt 4 ist anzuferti- 
gen für jedes Software-Anwendungssystem. Die Ent- 
scheidung über die Bestandteile der zu erstellenden 
Dokumentation trifft der Verantwortliche für das Soft- 
ware-Anwendungssystem. 
Es ist zulässig, Teildokumentationen wegzulassen, so- 
fern sie für den zuverlässigen Ablauf des Software-An- 
wendungssystems nicht erforderlich sind. 
Teildokumentationen brauchen insbesondere nicht eer- 
stellt zu werden, wenn hierfür auf Dokumente verwie- 
sen werden kann, die den Festlegungen dieses Stan- 
dards entsprechen. 
Es ist weiterhin zulässig, in den Teildokumentationen 
auf andere Teildokumentationen oder eine Dokumen- 
tation gemäß Abschnitt 3 zu verweisen. 


2.3. Gestaltung der äußeren Form 

Für die Gestaltung der äußeren Form von Dokumenta- 

tionen gemäß Abschnitt 3 bzw. Abschnitt 4 gelten fol- 

gende Festlegungen: 
a) Für den Abschnitt „Programmkenndaten” ist der 
Vordruck „Programmkenndaten“ {PKD) gemäß Ab- 
‚schnitt 5, zu verwenden bzw. bei rechnergestützter 
Erstellung der Dokumentation nachzugestalten. 
Ausfüllvorschrift siehe Punkt 3.1.1. 
b) Auf jeder Seite einer Dokumentation sind die Anga- 
ben zur 
° Zugehörigkeit (Name des Programmes bzw. Soft- 
ware-Anwendungssystems und Titel der Teildo- 
kumentation) _ 

e Einordnung (Seitennummer) 

e Aktualität (Datum der Erstellung) 
einzutragen. 

c) Das Deckblatt einer Teildokumentation muß min- 
destens folgende Angaben enthalten: 

— Bezeichnung des Programmes bzw. Software-An- 
wendungssystems 

— Bezeichnung der Teildokumentation 

— Verzeichnis aller zur Dokumentation gehörenden 
Teildokumentationen 

— Name des verantwortlichen Betriebes 


3. DOKUMENTATION VON PROGRAMMEN/ 
PROGRAMMSYSTEMEN 


3.1. Inhalt der Dokumentation 


3.1.1. Programmkenndaten 

Die Programmkenndaten sollen dem Benutzer eine 
schnelle Übersicht über das Programm bieten. Dazu 
bedarf es fachlicher, datenverarbeitungstechnischer 
und gegebenenfalls kommerzieller Angaben. 

Tabelle 1 legt den Inhalt der Programmkenndaten fest. 


Tabelle 1 


1. Programmbezeichnung 


1.1. Programmname 

Bezeichnung zur Identifizierung des Programmes in 
der Entwicklung, beim Vertrieb und beim Einsatz. Ge- 
gebenenfalls sind mehrere Programmnamen durch 
ihre Geltungsbereiche, z.B. im externen oder internen 
Schriftwechsel, in dem Datenverarbeitungssystem 
oder während eines bestimmten Zeitraums voneinan- 
der abzugrenzen. Ist das Programm Teil eines Pro- 
grammsystems, so ist auch dessen Name anzugeben. 


1.2. Variantenbezeichnung 


Zusatz zum Programmnamen, um mehrere gleichzei- 
tig einsetzbare Programmvarianten voneinander zu 
unterscheiden, z.B. bei verschiedenen Geräteausstat- 
tungen oder verschiedenen Anwendungsbereichen. 
Gegebenenfalls ist in einzelnen Abschnitten der Doku- 
mentation auf die Variante einzugehen. 


1.3. Versionsbezeichnung 
Zusatz zum Programmnamen und zur Variantenbe- 
zeichnung, um mehrere wegen Änderungen nachein- 
ander eingesetzte Versionen eines Programmes oder 
einer Variante voneinander zu unterscheiden. Die Do- 
kumentation muß den Änderungsstand (siehe Ta- 
belle 2, Nr.2.5) der gültigen Version beschreiben. 
Fortsetzung der Tabelle Seite 4 


Seite 4 TGL 44535 





Fortsetzung der Tabelle 1 


1.4. Freigabedatum - 


Datum der Freigabe sowohl der ersten als auch der ak- 
tuellen Programmversion. 


2.  Deskriptoren 

Schlüssel-, Schlag- oder Stichworte, die die durch das 
Programm gelöste Aufgabe und spezielle Eigenschaf- 
ten des Programmes charakterisieren und als Suchbe- 
griffe dienen können; gegebenenfalls Hinweise auf 
den verwendeten Deskriptorenkatalog. 


3. Atıfgabe 


3.1. Kurzbeschreibung 

Kurzgefaßte anwendungsbezogene Beschreibung der 
Aufgabe, die mit dem Programm gelöst wird, ein- 
schließlich der fachbezogenen Beschreibung der 
Ein- und Ausgabe. Die Aufgabe kann auch durch ein ty- 
pisches Anwendungsbeispiel, gegebenenfalls mit 
Skizze, verdeutlicht werden. 


3.2. Methoden 


Kurze Beschreibung der zur Lösung der Aufgabe ver- 
wendeten Theorien und Rechenverfahren. 


3.3. Vorschriften 


Hinweise auf Gesetze, Standards, Richtlinien und Vor- 
schriften, die Bestandteil der Aufgabenstellung sind. 


3.4. Besonderheiten 


Abgrenzung des Anwendungsbereiches für das Pro- 
gramm, insbesondere fachliche Voraussetzungen und 
Einschränkungen. 


4. ‚Gerätebedarf 

Angabe der für den Programmablauf vorgesehenen 
Geräte bzw. Gerätearten, gegebenenfalls in grafischer 
Darstellung. 


5. Programmgröße 

Als Programmgröße ist der maximale Speicherbedarf 
in gebräuchlichen und eindeutigen Einheiten anzuge- 
ben, z.B. in Byte. Bei Systemen mit virtuellem Speicher 
ist sowohl der maximale Bedarf an virtuellem Speicher 
als auch der minimale Bedarf an realem Speicher 
(Hauptspeicher) zu nennen. Falls erforderlich, ist der 
reale Speicher in ROM, PROM, RAM usw. zu unter- 
scheiden. | 
Der Speicherbedarf umfaßt Anweisungen bzw. Be- 
fehle, Daten, Ein- und Ausgabebereiche des beschrie- 


benen Programmes und aller für seinen Ablauf benö-. 


tigten Unterprogramme bzw. Programmbausteine. 
Kann der Speicherbedarf nicht absolut angegeben 
werden, ist eine Anleitung zu seiner Berechnung zu ge- 
ben. 


ö. Programmbedarf 


6.1. Betriebssystem 

Angabe von Hersteller, Name, Variante und Version 
der Betriebssysteme, unter deren Steuerung das Pro- 
gramm ohne Modifikation laufen kann. 


6.2. Unterprogramme 

Angabe von Hersteller, Name, Variante und Version 
der Unterprogramme, die zum Ablauf des Program- 
mes benötigt werden und nicht in ihm bereits enthal- 
ten sind, mit Verweis auf ihre Dokumentation. 


6.3. Sonstige Programme 

Angabe von Hersteller, Name, Variante und Version al- 
ler sonstigen zum Ablauf benötigten Programme, z.B. 
Hilfsprogramme oder weitere Programme, die Voraus- 
setzung für den Einsatz des Programmes sind. 


7. Programmiersprachen 


7.1. Sprachen 

Eindeutige Angabe der bei der Programmierung ver- 
wendeten Programmiersprachen, ihres Sprachum- 
fangs sowie der ungefähren Anzahl der Anweisungen 
(ausschließlich der Kommentare) in der jeweiligen 


Sprache. 
Beispiel: 
Sprache PL/1 COBOL 
Sprachumfang Angabe eines Stan- 
dards oder eines Pro- 
grammiersystems 
AnzahlderAnwei- 
sungen 250 850 


7.2. Übersetzer 

„Angabe der zu verwendenden Übersetzer- bzw. Gene- 
ratorprogramme mit Angabe der Hersteller sowie der 
Varianten- und Versionbezeichnungen. 


8.  Betriebsarten 


Angabe der vorgesehenen Betriebsarten, z.B. Stapel-, 
Dialog- oder Echtzeitbetrieb. 


9. Dateien 


9.1. Bezeichnung, Verwendungszweck 

und Datenträger 
Bezeichnung aller vom Programm verwendeten Da- 
teien mit Angabe der ihnen zugeordneten Verwen- 
dungszwecke und Datenträger/Datenträgerarten. 


9.2. Speicherbedarf 

Der Speicherbedarf für jede Datei ist in gebräuchlichen 
Einheiten, z.B. n Blöcke zu je m Bytes, anzugeben. Statt 
einer zahlenmäßigen Angabe genügt eine Anweisung 
zur Ermittlung des Speicherbedarfs. Gegebenenfalls 
sind die Ober- und Untergrenzen des Speicherbedarfs 
zu nennen. 


9.3. Dateiorganisation 


Für jede Datei ist die verwendete Dateiorganisation an- 
zugeben, z.B. sequentiell, gestreut mit bzw. ohne 
Schlüssel. 


9.4. Zugriffsart 


Für jede Datei sind die verwendeten Zugriffsarten an- 
zuführen, z.B. physisch-sequentiell, logisch-sequen- 
tiell oder wahlfrei. 


Fortsetzung der Tabelle Seite 5 
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10. Konventionen 

Angabe der bei der Anwendung des Programmes zu 
berücksichtigenden rechtlichen, technischen oder or- 
ganisatorischen Bedingungen, die sich aus Gesetzen, 
Standards, Verträgen oder Richtlinien ergeben, z.B. 
Urheberrechte, Weitergabe- oder Mitnutzungsverein- 
barungen, Garantie, Vorschriften zur Gewährleistung 
von Ordnung und Sicherheit. 


11. Zuständigkeiten 

Anschriften der Institutionen bzw. der Personen, die 

für 

— Entwicklung, 

— Vertrieb, 

— Wartung, Pflege (Fehlerbeseitigung und Aktualisie- 
rung) 

— Weiterentwicklung 

des Programmes zuständig sind. 


12. Unterlagen 

Verzeichnis der Unterlagen, die zur Information über 
das Programm zur Verfügung stehen, z.B. Anleitung 
für den Programmierer, Anleitung für den Systemver- 
antwortlichen, Anwenderbeschreibung oder Pro- 
grammdokumentation, mit Quellenangabe und gege- 
benenfalls Bestell-Nr. 


13. Sonstige Angaben 


Für den Vertrieb von Programmen können die folgen- 
den Angaben zusätzlich gemacht werden. 


13.1. Installierungen 

Angabe von Datenverarbeitungsanlagen, auf denen 
das Programm installiert ist, mit Nennung von Herstel- 
ler, Anlagentyp, Betriebssystem und jeweiliger Anzahl 
von Installierungen. 


13.2. Preise/Kosten 
Angaben für 

— Kaufpreis 

— Installierungskosten 

— Wartungs-(Pflege-)Kosten 
— Schulungskosten 

und deren Verbindlichkeiten. 


3.1.2. Funktion und Aufbau des Programmes 


Durch die Angaben zu Funktion und Aufbau des Pro- 
grammes müssen die nachstehenden Fragen beant- 
wortet werden: 

„Was soll das Programm tun?” 

„Wie werden die Anforderungen im Programm er- 
füllt?” 

„Wie ist das Programm aufgebaut?” 

(Darstellung der Struktur des Programmes) 

„Wie läuft die Verarbeitung im Programm ab?“ 
(Beschreibung des Programmablaufs von der Eingabe 
bis zur Ausgabe) 

„Mit welchen Daten arbeitet das Programm?” 
(Beschreibung der Daten) 

Entsprechungen zwischen den Abschnitten sind durch 
Querverweise zu verdeutlichen. 

Tabelle 2 legt den Inhalt zu diesem Informationskom- 
plex fest. 


Tabelle 2 


1. Aufgabenstellung R 


1.1. Aufgabenbeschreibung 

Die mit dem Programm lösbaren Aufgaben sind in all- 
gemein verständlicher Form darzustellen, soweit eine 
über Tabelle 1, Nr.3.1. hinausgehende Detaillierung 
erforderlich ist. 


1.2. Theoretische Grundlagen 


Angabe der theoretischen Grundlagen, die der fachli- 
chen Lösung der Aufgabe zugrunde liegen. Die ange- 
wendeten Verfahren sind in ihren wesentlichen Schrit- 
ten zu beschreiben. 


1.3. Randbedingungen 


Angabe der in der Aufgabenstellung festgelegten 
Randbedingungen, z.B. fachliche oder rechentechni- 
sche Randbedingungen. 


1.4. Maßeinheiten 

Zusammenstellung der Größen mit Angabe des Ein- 
heitenzeichens der verwendeten Einheit, z.B. Länge in 
m. 


1.5. Vorschriften 

Die bei der Aufgabenstellung berücksichtigten Stan- 
dards, Richtlinien, Bestimmungen, Vorschriften usw. 
sind in ihren für das Programm wichtigen Teilen mit 
ausführlichen Quellenangaben und dem Datum des In- 
krafttretens zu benennen und gegebenenfalls zu inter- 
pretieren. Abweichungen sind aufzuzeigen. 


1.6. Literaturhinweise 


Zusammenstellung von Schrifttum, das bei der fachli- 
chen Lösung der Aufgabe herangezogen wurde. 


2. Aufgabenlösung 


2.1. Vereinbarungen 


Angabe der Darstellungsform und -regeln, die in den 

folgenden Dokumentationsteilen verwendet werden, 

z.B. spezielle Bedeutung von Zeichen oder Zeichen- 

kombinationen. Aufstellung der für die Problemlösung 

getroffenen Konventionen, insbesondere über 

— Vorzeichen 

— Genauigkeiten 

— Rundung 

— Koordinatensysteme 

— Wertebereiche 

— tabellarische Darstellung der verwendeten Kurzbe- 
zeichnungen und deren Bedeutungen 

— datenverarbeitungstechnische Regelungen. 


2.2. Algorithmen 

Beschreibung der Lösungsverfahren und Algorith- 
men, dargestellt im Zusammenhang einerseits mit der 
Aufgabenstellung und andererseits mit dem Programm- 
aufbau. Benennung der bei der Erstellung des Pro- 
grammes benutzten Verfanren, z.B. Normierte Pro- 
grammierung, Entscheidungstabellen, datenorien- 
tierte Strukturierung usw. 


Fortsetzung der Tabelle Seite 6 
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2.3. Schlüsselverzeichnis 


Beschreibung des Formats und der Bedeutung der ver- 
wendeten Verschlüsselungen. Darstellung der Syste- 
matik ihres Aufbaus und Angabe der zulässigen Werte. 


2.4. Fehlerbehandlung 

Darstellung der Fehlerprüfungen mit Angabe der vor- 
gesehenen Fehlermeldungen und der daraus resultie- 
renden Maßnahmen 


2.5. Änderungen 


Für jede Änderung ist anzugeben: 
— Variantenbezeichnung 

— Versionsbezeichnung, 

— Anlaß und Inhalt der Änderung 
— Freigabezeitpunkt 

— Zeitpunkt der Inbetriebnahme. 


3. Programmaufbau 


3.1. Programmstruktur 

Gliederung des Programmes in Programmbausteine, 
z.B. Unterprogramme, Modulin, Segmente, gemein- 
same Speicherbereiche, in Anlehnung an die Aufga- 
benlösung (siehe Nr. 2.2.). Diese Gliederung kann gra- 
fisch, z.B. durch eine Baumstruktur oder verbal durch 
einen entsprechend gegliederten Text dargestellt wer- 
den. . 


3.2. Programmbausteine 

In der Liste sind die Namen, die Eingangspunkte und 
die Schnittstellen der Programmbausteine sowie ihre 
Beziehungen zueinander darzustellen. 


3.3. Quelldarstellung 

Folge der Anweisungen und Vereinbarungen, z.B. An- 
fangswerte und Konstante, in der Quellsprache, ein- 
schließlich Kommentaren in der für den Ablauf der 
Übersetzerprogramme bestimmten Form. Die Quell- 
darstellung kann auch Bestandteil der vom Überset- 
zerprogramm erzeugten Umwandlungsliste sein. 
Sofern Software-Werkzeuge verwendet werden, um- 
faßt die Quelldarstellung sowohl die Eingabe für die 
Werkzeuge, als auch die Eingabe für UÜbersetzerpro- 
gramme (d.h. die Ausgabe von Software-Werkzeu- 
gen). 


3.4. Übersetzer- und Binderlisten 

Vom Übersetzer- und Binderprogramm ausgegebene 

Protokolle, aus denen die Umsetzung von der Quell- 

darstellung bis zur lade- und ablauffähigen Form er- 

sichtlich ist. Nach Möglichkeit sind zur Unterstützung 

von Test, Fehlersuche und Programmänderungen zu- 

sätzlich bereitzustellen: 

— Liste des übersetzten Programmes einschließlich 
Fehlerprotokoll, 

— Liste der symbolischen Adressen und der ihnen zu- 
geordneten Speicheradressen, 

— Liste zur Rückverfolgung von Adressbezügen und 

— Liste der beim Laden noch abzudeckenden Adress- 
bezüge. 

Sofern Software-Werkzeuge verwendet werden, um- 

faßt dieser Punkt auch die Protokolle dieser Pro- 

'gramme. 


4. Programmablauf 
4.1. Datenflußbeschreibung 


Der Datenfluß ist — gegebenenfalls in mehreren De- 
taillierungsstufen — darzustellen, z.B. durch Daten- 
flußpläne; siehe TGL 22451. Alle ein- und auszugeben- 
den Daten sowie alle zwischen Programmbausteinen 
zu übergebenden Daten sind bezüglich ihrer Bedeu- 
tung, ihrer zeitlichen Folge, der Datenträger sowie der 
Ein- und Ausgabegeräte anzugeben. 


4.2. Programmablaufbeschreibung 

Der interne Ablauf des Programmes ist — gegebenen- 
falls in mehreren Detaillierungsstufen — zu beschrei- 
ben. Insbesondere sind Programmbausteine, Unterab- 


läufe, Verzweigungen, Schleifen und gegebenenfalls 


Synchronisationsschnitte darzustellen. 
Beschreibungsmittel sind z.B. 

— Programmablaufpläne, siehe TGL 22451 

— Entscheidungstabellen 

— Eingabe-Verarbeitung-Ausgabe-Tabellen 

— Strukturdiagramme 

— Pseudocode. 

Die Beschreibungsmittel können miteinander kombi- 
niert werden, soweit dies zur Beschreibung des Ab- 
laufs geeignet ist. Die Ablaufbeschreibung muß eine 
lückenlose Vorwärts- und Rückwärtsverfolgung des 
Ablaufs ermöglichen; hierfür sollen Querverweise auf 
die Quelldarstellung verwendet werden. 


5. Daten 


5.1. Datenmodell 

Es ist eine Übersicht über die logische Datenstruktur 
des Programmes, z.B. konzeptionelles Schema einer 
Datenbank, in Anlehnung an die Aufgabenlösung zu 
geben. 


5.2. Eingabedaten 

Bei der Eingabe in das Programm ist zu unterscheiden 
zwischen Daten, die bereits gespeichert und verarbeit- 
bar als Dateien vorliegen, und Daten, die zum Zweck 
ihrer Verarbeitung erfaßt werden müssen. 

Ergänzend zu den Angaben über die Datenorganisa- 
tion ist der verwendete Zugriffsalgorithmus zu be- 
schreiben oder zu benennen. Für die zu erfassenden 
Daten sind die Erfassungsregeln darzustellen; dies gilt 
auch für Steueranweisungen und ihre Funktionen. Fer- 
ner ist anzugeben, ob und weiche Initialisierungswerte 
das Programm für nicht eingegebene Daten einsetzt. 
Bei formatgebundener Eingabe ist die Reihen- 
folge der Daten anzugeben. Zur Verdeutlichung sind 
Erfassungsbelege beizufügen. 

Bei formatfreier Eingabe sind die Eingabe-Verein- 
barungen anzugeben, z.B. 

— Trennzeichen und deren Funktion 

— Schlüsselwörter zur Identifizierung der Daten 

— Auslassungszeichen. 

Bei Bereitstellung einer „Sprachbeschreibung” sind 
hiernur allgemeine Angaben aufzunehmen, undfürde- 
taillierte Informationen ist auf die „Sprachbeschrei- 
bung” zu verweisen. 
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5.3. Ausgabedaten 

Bei der Ausgabe aus dem Programm wird unterschie- 
den zwischen Daten, die für die weitere Verarbeitung 
in Datenverarbeitungssystemen als Dateien gespei- 
chert werden und Daten, die außerhalb von Datenver- 
arbeitungssystemen weiter verarbeitet werden sollen, 
z.B. Listen, Bildschirmausgaben, grafische Darstellun- 
gen und Stellwertausgaben zur Steuerung technischer 
Prozesse. 

Die für die Weiterverarbeitung außerhalb von Daten- 
verarbeitungssystemen bestimmten Daten, ein- 
schließlich der für den Benutzer bestimmten Pro- 
grammnachrichten, sind durch Ausgabemuster, z.B. 
Listenbilder, mit Interpretationshilfen oder durch Re- 
geln zu ihrer Erstellung zu beschreiben. 


5.4. Temporäre Dateien 

Darstellung der während der Zeit des Programmab- 
laufs erstellten und benutzten Dateien, die nur wäh- 
rend des Programmablaufs von Bedeutung sind. 


5.5. Interne Daten 

5.5.1. Tabellenübersicht 

Verzeichnis der im Rahmen des Programmes verwen- 
deten Tabellen bzw. Datenlisten mit Angabe ihrer 
Funktion, ihres Umfangs und ihrer Verbindung unter- 
einander. Beschreibung ihres Aufbaus und des Auf- 
baus ihrer Elemente aus Datenfeldern. 

5.5.2. Kontrollblockbeschreibung 

Beschreibung der für die Programmsteuerung be- 
deutsamen internen Daten und Kennwerte bezüglich 
ihrer Formate, ihres Aufbaus und ihrer Funktion. 

‚Die Verbindung zwischen den Kontrollblöcken und zwi- 
schen Kontrollblöcken und Tabellen sind darzustellen. 
5.5.3. Variableund Konstanten 

Beschreibung der noch nicht nach den Nummern 5.5.1. 
und 5.5.2. erfaßten DatenbereichefürVariableundKon- 
stanten, soweit diese Beschreibung nichteindeutig aus 
der Quelldarstellung bzw. Umwandlungsliste hervor- 
geht. 


6. _ Anwendungsbedingungen 

Angaben der bei der Anwendung des Programmes zu 
beachtenden Bedingungen, z.B. die maximale verar- 
beitbare Datenmenge. 


7. Datensicherung 

Beschreibung der im Programm vorgesehenen Maß- 
nahmen oder Einrichtungen zur Datensicherung (s. Ta- 
belle 4,Nr..2.3.). 


8. Anwendungsbeispiel 

Inmindestens einemtypischen Anwendungsfall istbei- 

spielhaft die Funktion des Programmes darzustellen. 

Hierzu gehören folgende Unterlagen: 

— Beschreibung des Anwendungsfalls (verbal oder 
durch eine Skizze) 

— Eingabe, z.B. ausgefüllte Vordrucke 

— Ergebnisse,z.B. Ausdrucke. 

FürProgrammemit mehreren Variantenkann eszweck- 

mäßig sein, mehrere Anwendungsfälle aufzuführen. 


3.1.3. Installierung des Programmes und Test 
der Funktionsfähigkeit 


Dieser Informationskomplex muß alle Angaben bein- 
halten, die erforderlich sind, um das Programm auf ei- 
nerRechenanlagezuinstallierenundseine Funktionsfä- 
higkeit zu überprüfen. Die Einzelanforderungen bein- 
haltet Tabelle 3. 


Tabelle 3 


1.  Installierung des Programmes 


1.1. Ubergabeform 

Beschreibung der Darstellungen, in denen das Pro- 

gramm übergeben wird. Gegebenenfalls sind mehrere 

Darstellungsformen, z.B. bei Verwendung verschiede- 

ner Datenträger, zu beschreiben. Fürjede Darstellungs- 

form sind mindestens die folgenden Angaben zu ma- 

chen: 

— Bezeichnung des Datenträgers 

— Spezifizierung der Darstellung des Programmes auf 
dem Datenträger, z.B. Schreibdichte, Code, Kenn- 
sätze undBlockungsfaktor. 

Gegebenenfalls sind die Programme und Betriebssy- 

steme zu nennen, mit denen das Programm auf die Da- 

tenträger geschrieben wurde. 


1.2. Anpassungshinweise 

Angabe der Programmänderungen, die erforderlich 

sind, um das Programm anzupassenan: 

— verwendete Datenverarbeitungsanlagen, peri- 
phere Geräte und gegebenenfalls Betriebssysteme 

— für den Ablauf erforderliche andere Programme 

— Anwenderanforderungen, z.B. Festlegung von 
Feldgrößen oder Optimierung des Hauptspeicher- 
bzw. Rechenzeitbedarfs. 

Darüber hinaus sind Änderungen an anderen Program- 

men, z.B. an Betriebssystemen anzugeben. 

Ferner Angaben der für das Programm erforderlichen 

nicht standardgemäßen Betriebssystem-Leistungen, 

z.B. Generierungsoptionen. 


1.3. Aufbewahrungsbedarf 

Angabe des Speicherbedarfsfür die Aufbewahrung des 
ablauffähigen Programmes in gebräuchlichen Einhei- 
ten,z.B.BytesoderWorte. 


1.4. Übersetzen undBinden 

Darstellung der Maßnahmen einschließlich Steueran- 
weisungen für Übersetzungs- und Binderlauf, gegebe- 
nenfalls Beschreibung der Überlagerungsstruktur. 


1.5. Einrichten von Dateien 

Darstellung der Maßnahmen einschließlich Steueran- 
weisungen für das Einrichten der Dateien, soweit dies 
nichtausden Angaben nach Tabelle 4,Nr.2.2.2.eindeu- 
tig hervorgeht. 


1.6. Datensicherung 

Angabe aller erforderlichen Maßnahmen zur Datensi- 

cherung (siehe Tabelle 4, Nr.2.3.) während der Instal- 
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lierungsphase. Hierzu gehören auch Maßnahmen zur 
Sicherung des Programmes und der zugehörigen Da- 
teien. 


2.  Testder Funktionsfähigkeit 


2.1. Verfahren 


Angabe oder Beschreibung der Testverfahren (Metho- 
den und Programme), mit denen der fehlerfreie Ablauf 
des Programmes bei Installierung und Programm- 
pflege geprüft werden kann. 


2.2. Daten und Ergebnisse 


Darstellung der Testfälle, der Eingabedaten und Er- 
gebnisse, durch die der fehlerfreie Ablauf des Pro- 
grammes geprüft werden kann. Eingabedaten und Er- 
gebnisse sind in einer Form beizufügen, die die Über- 
prüfung der Ergebnisse ermöglicht. 


3.1.4. Betrieb des Programmes 


Hierzu sind alle Angaben aufzunehmen, die erforder- 
lich sind, um die technischen Bedingungen für den Be- 
trieb zu gewährleisten, sowie die einwandfreie Bedie- 
nung im Normal- und Havariefall zu ermöglichen. 
Tabelle 4 legt die Einzelanforderungen fest. 


Tabelle 4 


1.  Gerätebedarf 


Für jede Geräteart sind alle Eigenschaften zu nennen, 
die für den Einsatz des Programmes von Bedeutung 
sind. Weiterhin sind wesentliche Grenzbedingungen, 
z.B. Minimalbedarf, maximale Anzahl einsetzbarer Ge- 
räte, zu beschreiben. Abhängigkeiten von Geräteaus- 
stattungen untereinander sowie zwischen Funktions- 
einheiten der Zentraleinheit und peripheren Einheiten 
sind darzustellen. 


1.1. Zentraleinheit 


Angabe der Bezeichnungen der Zentraleinheiten, auf 
denen das Programm einsetzbar ist, sowie gegebe- 
nenfalls der benötigten Zusatzeinrichtungen und Mi- 
kroprogrammbausteine. 


1.2. Datenperipherie 


Angabe der . 

— Geräte für serielle Ein- und Ausgabe, 

— peripheren Speicher für wahlfreien Zugriff, 

— dialogfähigen Geräte. 

Wenn für das Programm zutreffend, sind je nach Gerä- 
teart folgende technischen Merkmale zu beschreiben: 
— Aufzeichnungsart 

— Zeichendichte 

— Zeichenvorrat 

— Code 

— Zeilen- bzw. Blocklänge 

— Speicherkapazität 

— Ubertragungsprozedur 

Gegebenenfalls genögt der Verweis auf andere Stan- 
dards für diese Geräte. 


1.3. Prozeßperipherie 

Angabe der 

— Analogeingabe- und Analogausgabeeinheiten 

— Digitaleingabe- und Digitalausgabeeinheiten. 

Wenn für das Programm zutreffend, sind folgende 

technische Merkmale zu beschreiben: 

— Genauigkeit 

— Umwandlungszeit 

— Zykluszeit 

— Zusammenschluß mehrerer Funktionseinheiten 

— Abhängigkeit der Übertragungseigenschaften von 
Anschlußart und -entfernung. 


1.4. Rechnerkopplung 


Angabe der Anzahl der gekoppelten Prozessoren oder 
Zentraleinheiten, ihrer Beziehung untereinander 
(Haupt- und Nebenrechner, Stern, Kette oder Netz) so- 
wie der technischen Ausführung der Kopplung, z.B. 
durch Datenübertragung oder über gemeinsame Spei- 
cher. Angabe der Anweisungen oder Programme für 
die Kommunikation zwischen den gekoppelten Prozes- 
soren oder Zentraleinheiten. 


1.5. Datenübertragung 

Beschreibung des Übertragungsnetzes, z.B. Stand- 
oder Wählleitungen, das vom Programm gesteuert 
wird. Angabe der benötigten Steuereinheiten, Konzen- 
tratoren, Modems oder sonstiger Datenumsetzer und 
Zusatzausstattungen. Angabe der Übertragungspro- 
zedur sowie der Übertragungsgeschwindigkeit, Feh- 
lerüberwachung und Fehlerbeseitigung. 


2. Normalbedienung 


2.1. Rüstanweisungen 

Angaben zur Vorbereitung der peripheren Geräte für 
den Programmablauf und zur Bereitstellung des benö- 
tigten Materials, z.B. Lochkarten, Druckpapier. 


2.2. Programmsteuerung und -überwachung 

im Rechenzentrumsbetrieb 
Es ist zulässig, die Angaben zu diesem Punkt in eine 
Anlage zu verlagern, sofern zu beachtende Werkstan- 
dards oder andere betriebliche Regelungen zu sehr 
ausführlichen Beschreibungen führen. 


2.2.1. Betriebsarten 

Angabe der Bedingungen und Voraussetzungen für 
den Einsatz verschiedener Betriebsarten und der durch 
die Betriebsart bedingten Abweichungen im Program- 
mablauf. 


2.2.2. Steueranweisungen 


Darstellungen der Steueranweisungen für Laden, Star- 
ten und Ablauf des Programmes. 


2.2.3. Programm-Meldungen 

Darstellung aller im Programm vorgesehenen Mel- 
dungen für den Rechenzentrumsbetrieb. Sie soll Anga- 
ben über die die Ursache der Meldungen enthalten, 
und erforderliche Maßnahmen beschreiben. 
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2.3. Datensicherung 

Beschreibung der Maßnahmen oderEinrichtungen zur 
Bewahrung von Daten vor unabsichtlicher oder beab- 
sichtigter Beeinträchtigung mit tatsächlicher oder 
möglicher nachteiliger Wirkung. 


3. Unterbrechungen im Programmablauf 


3.1. Programmunterbrechung und -abbruch 
Anweisungen zur geregelten Unterbrechung des Pro- 
grammablaufs oder zum vorzeitigen Beenden des Pro- 
grammablaufs in Notfällen. Angabe möglicher Pro- 
grammabbrüche und zugeordneter Maßnahmen, z.B. 
Sicherung von Dateien und Ergebnissen. 


3.2. Sicherung von Zwischenergebnissen 
Beschreibung der Maßnahmen zur Sicherung der zum 
Zeitpunkt des Abbruchs vorhandenen Ergebnisse oder 
Zustände. Gegebenenfalls Hinweis auf Wiederanlauf- 
verfahren. 


4.  Wiederanlauf 


4.1. Wiederanlaufverfahren 

Angabe der Maßnahmen zur Wiederherstellung eines 
verarbeitungsfähigen Zustands der Dateien. 
Benennung bzw. Beschreibung des für den Wiederan- 
lauf vorgesehenen Verfahrens. 


4.2. Wiederanlaufanweisungen 
Darstellung der für den Wiederanlauf zu verwenden- 
den Steueranweisungen. 


5.  Leistungsmerkmale 

Angaben, die es im konkreten Einzelfall ermöglichen, 
die Leistungsfähigkeit des: Programmes abzuschät- 
zen. Hierzu gehören z.B. Zeitbedarf des Programmes 
in bezug auf die zu verarbeitenden Datenmengen, ge- 
gebenenfalls gegliedert nach den verwendbaren Ge- 
räteausstattungen, und maximaler Umfang der in ei- 
nem Programmablauf zu verarbeitenden Daten. 

Als Zeitbedarf kann je nach Betriebsart, Betriebssy- 
stem oder Organisationsform die CPU-Zeit, Verweil- 
zeit, Antwortzeit, Reaktionszeit usw. angegeben wer- 
den. 


3.2. Gliederung der Dokumentation 
Die Anwenderdokumentation gliedert sich in Teildoku- 
mentationen, die sich bezüglich ihrer inhaltlichen Zu- 
sammenstellung an dem Personenkreis orientieren, 
der sie im Rahmen der Anwendung benötigt. 
Die Anwenderdokumentation umfaßt 
— Programmkenndaten 
— Beschreibungen zur fachlichen Anwendung mit 

e Anwenderbeschreibung 

.e Sprachbeschreibung 

e Anleitung für den Nutzer bzw. Programmierer 


— Beschreibungen zur programm- und rechentechni- 
schen Anwendung mit 
Anleitung für den Systemverantwortlichen 
° Anleitung für den Bediener 


— Programmbeschreibung. 

Es ist zulässig, Teildokumentationen wegzulassen, 
wenn diese für die Anwendung eines Programmes 
nicht erforderlich sind. 

Es ist weiterhin zulässig, Teildokumentationen unter 
den o.g. Gruppenüberschriften zusammenzufassen. 


Anmerkung: 

Die Gliederung orientiert sich an den Personenkreisen, 
die die jeweilige Teildokumentationen in der Regel 
nutzen. Ihr liegen folgende Überlegungen zugrunde: 


a) Für mehrere Zwecke, insbesondere Information/ 
Dokumentation und Vertrieb wird eine selbstän- 
dige Kurzbeschreibung benötigt. 

— Programmkenndaten — 


b 


mn 


Der Anwender benötigteine Beschreibung, die sich 
in erster Linie an den zu lösenden fachlichen Aufga- 
ben orientiert und keine Details zur rechentechni- 
schen Lösung bringt. 

— Beschreibung zur fachlichen Anwendung — 


c) Der Verantwortliche für die rechentechnische Abar- 
beitung benötigt eine Beschreibung, die sich in er- 
ster Linie an der rechentechnischen Bedienung, 
einschließlich der Installation und Klärung von 
Fehlabläufen orientiert. Das bearbeitete fachliche 
Problem ist dabei von sekundärer Bedeutung. 

— Beschreibung zur programm- und rechentechni- 
schen Anwendung — 


d) Beim Einsatz von dezentraler Datentechnik ist zu 
beachten, daß Anwender und Bediener durch die- 
selbe Person repräsentiert werden können. Im all- 
gemeinen werden von dieser Person aber nicht In- 
stallation, Test und Klärung von Fehlabläufen vor- 
genommen. Diesem Sachverhalt ist durch eine 
zweckmäßige Gestaltung der entsprechenden Ab- 
schnitte (Verweise, Zusammenfassung z.B. der An- 
leitung für den Bediener und der Anleitung für den 
Nutzer) Rechnung zu tragen. 


e) Weder Anwender, noch Verantwortliche für den 
rechentechnischen Betrieb benötigen die Pro- 
grammbeschreibung. Diese wird nur für pro- 
grammtechnische Veränderungen: oder Klärung 
von Programmfehlern benötigt. Beides erfordert 
spezielle Sachkenntnisse und einen höheren Zeit- 
aufwand. Dieser Dokumentationsteil wird daher, 
aber auch aus Sicherheitsgründen, nur dem War- 
tungsverantwortlichen zur Verfügung gestellt. Die- 
ser benötigt für die Wahrnehmung seiner Aufga- 
ben jedoch auch die anderen Dokumentationsteile. 
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Programmkenndaten 


Tabelle 5 


1. Programmkenndaten | Tabelle 1, Nr. 1.-13. 


Anwendungsbeschreibung 


Tabelle 6 


1. Programmkenndaten | Tabelle 1, Nr. 1.-13. 


2. Aufgabenstellung 


2.1. Aufgabenbeschreibung Tabelle 2,Nr. 1.1. 


2.2. Theoretische Grundlagen | Tabelle 2,Nr. 1.2. 


2.3. Randbedingungen Tabelle 2, Nr. 1.3. 


2.4. Maßeinheiten Tabelle 2, Nr. 1.4. 


2.5. Vorschriften Tabelle 2, Nr. 1.5. 





2.6. Literaturhinweise Tabelle 2, Nr. 1.6. 


3. Aufgabenlösen 





3.1. Vereinbarungen Tabelle 2, Nr. 2.1. 


3.2. Algorithmen Tabelle 2, Nr. 2.2. 


3.3. Schlüsselverzeichnis Tabelle 2, Nr. 2.3. 


3.4. Fehlerbehandlung - Tabelle 2,Nr. 2.4. 





3.5. Änderungen Tabelle 2, Nr. 2.5. 


4. Daten 


4.1. Datenmodell Tabelle 2,Nr. 5.1. 
Tabelle 2, Nr. 5.2. 
oder Verweis auf 
Sprachbeschrei- 
bung gemäß Ta- 
belle 7 


4.2. Eingabedaten 


4.3. Ausgabedaten Tabelle 2, Nr. 5.3. 


5.  Anwendungsbedingungen | Tabelle 2, Nr. 6. 


6. Datensicherung Tabelle2,Nr.7 


7. Anwendungsbeispiel Tabelle 2,Nr.8. 









Sprachbeschreibung 
Tabelle 7 


1. Allgemeine Angaben 

— Eigenschaften der Sprache, Anwendungs- 
reich 3 

— Übereinstimmung mit bzw. Abweichungen 
gegenüber standardisierten Sprachen 
oder Sprachversionen 

— Anwendungsbedingungen 

— Notation. 


2. Termini und Definitionen 


— Terminologie 
— Vereinbarungen 
— Konzeption der Sprache. 


3. Sprachelemente 
Beschreibung von Syntax und Semantik der Sprache- 
lemente. 


4. Anwendung 
Beschreibung der Anwendung, Hinweise zur Anwen- 
dung. 


Diese Teildokumentation ist erforderlich, wenn .die 
Eingabedaten ganz oder teilweise eine komplizierte 
Syntax und Semantik aufweisen, so daß eine Darstel- 
lung gemäß Tabelle 2, Nr.5.2., nicht anwendungs- 
freundlich und somit unzweckmäßig ist. 

Gemäß Tabelle 2, Nr.5.2., sind dann nur allgemeine 
Angaben aufzunehmen. Für ausführliche Informatio- 
nen ist auf die Sprachbeschreibung zu verweisen. 
Anmerkung: 

Sofern eine Kommandobeschreibung erforderlich ist, 
kann die Gliederung der Sprachbeschreibung sinnge- 
mäß angewendet werden. 


Anleitung für den Nutzer/Programmierer 


Tabelle 8 
1. Programmkenndaten 


2. Nutzung der Programmfunktionen 


Beschreibung der Nutzung der Programmfunktionen, 

wobei diese Beschreibung über den Detailliertheits- 

grad der Anwenderbeschreibung wesentlich hinaus- 

gehen soll. Für die Programmfunktionen sind im we- 

sentlichen anzugeben: 

— Eingabedaten 

— Steuerparameter 

— Ausgabedaten 

— mögliche Fehler mit Verweis auf Fehlermeldungen 

— Hinweise im Zusammenhang mit der Gerätetech- 
nik. 


3. Mitteilungen an den Nutzer/Programmierer 
Angabe von Nachrichtennummer, Nachrichtentext, 
Bedeutung der Nachricht und notwendige Reaktionen 
des Nutzers/Programmierers, siehe auch Tabelle 2, 
Nr.5.3. 
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4. Quelltext und programmiermethodische 
Hinweise 

Der Quelltext oder Teile davon sind nur erforderlich, 

wenn vorzunehmende Anpassungen sich auch auf die- 

sen beziehen und dafür nicht auf die Programmbe- 

schreibung verwiesen werden kann. 


Diese Teildokumentation ist für jede Zielgruppe bereit- 
zustellen, die in Verbindung mit der Anwendung spe- 
zielle Informationen benötigt, die in der Anwenderbe- 
schreibung nicht, bzw. nicht in der erforderlichen De- 
tailliertheit, enthalten sind. Die Zielgruppe ist im Unter- 
teil der Dokumentation zu nennen, und der Inhalt ist in 
Verständlichkeit, Terminologie und Verbindlichkeits- 
grad auf die Zielgruppe abzustimmen. 

Anmerkung: 

Als Zielgruppe können z.B. Mitarbeiter einer Fachab- 
teilung, Datenerfassungspersonal und/oder EDV-Spe- 
zialisten auftreten. 


Anleitung für den Systemverantwortlichen 


Tabelle 9 


1. Programmkenndaten | Tabelle 1, Nr. 1.-13. 


2. Installierung des Programmes 









2.1. Übergabeform Tabelle 3, Nr. 1.1. 


2.2. Anpassungshinweise Tabelle 3, Nr. 1.2. 


2.3. Aufbewahrungsbedarf Tabelle 3, Nr. 1.3. 
2.4. Übersetzen und Binden Tabelle 3,Nr. 1.4. 


2.5. Einrichten von Dateien Tabelle 3, Nr. 1.5. 





Tabelle 3, Nr. 1.6. 





2.6. Datensicherung 


3.  TestderFunktionsfähigkeit 


3.1. Verfahren Tabelle 3, Nr. 2.1. 





Tabelle 3,Nr. 2.2. 


3.2. Daten und Ergebnisse 


4.  Geräte- und sonstiger Ressourcenbedart 









4.1. Zentraleinheit Tabelle 4, Nr. 1.1. 


4.2. Datenperipherie Tabelle 4, Nr. 1.2. 


4.3. Prozeßperipherie Tabelle 4, Nr. 1.3. 


4.4. Rechnerkopplung Tabelle 4,Nr. 1.4. 





4.5. Datenübertragung Tabelle 4, Nr. 1.5. 


5. Normalbedienung 






. Rüstanweisungen Tabelle4,Nr.2.1. 







5.2. Programmsteuerung und 


-überwachung Tabelle 4, Nr. 2.2. 


Tabelle 4, Nr. 2.3. 











. Datensicherung 





6. Unterbrechungen im Programmablauf 






. Programmabbruch Tabelle 4, Nr. 3.1. 
6.2. Sicherung von Zwischen- 


ergebnissen Tabelle 4, Nr. 3.2. 





7.  Wiederanlauf 







7.1. Wiederanlaufverfahren Ta belle 4,Nr. 4.1. 


7.2. Wiederanlaufanweisungen]| Tabelle 4,Nr. 4.2. 





Leistungsmerkmale Tabelle 4, Nr.5 





Anleitung für den Bediener 

Diese Teildokumentation ist getrennt für jedes Be- 
triebssystem (gebunden an bestimmte Gerätetech- 
nik) zu erstellen, wenn mehrere Betriebssysteme zur 
Anwendung kommen. 


Tabelle 10 


1. Programmkenndaten | Tabelle 1, Nr. 1.-13. 


2. Normalbedienung 






2.1. Rüstanweisungen Tabelle 4, Nr. 2.1. 






2.2. Programmsteuerung und 


-überwachung Tabelle 4,Nr. 2.2. 





Tabelle 4, Nr. 2.3. 







2.3. Datensicherung 





3. Unterbrechungen im Programmablauf 






3.1. Programmabbruch Tabelle 4,Nr. 3.1. 
3.2. Sicherung von 


Zwischenergebnissen Tabelle 4, Nr. 3.2. 





4.  Wiederanlauf 


4.1. Wiederanlaufverfahren Tabelle 4, Nr. 4.1. 


4.2. Wiederanlaufanweisungen| Tabelle 4, Nr. 4.2. 
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Programmbeschreibung 
Tabelle 11 





Tabelle 1,Nr. 1.-13. 
Tabelle 2, Nr. 2.5. 
Tabelle 2, Nr. 2.1. 
Tabelle 2,Nr. 2.2. 








Programmkenndaten 
Änderungen 
Vereinbarungen 
Programmfunktion 


a 





5. Programmaufbau 








Tabelle 2, Nr. 3.1. 
Tabelle 2, Nr. 3.2. 
Tabelle 2, Nr. 3.3. 


. Progrdmmstruktur 
5.2. Programmbausteine 
5.3. Quelldarstellung 


. Übersetzer- und 
Binderleisten 






Tabelle 2, Nr. 3.4. 





6. _ Programmablauf 


6.1. Datenflußbeschreibung Tabelle 2, Nr. 4.1. 


6.2. Programmablauf- 
beschreibung 





Tabelle 2, Nr. 4.2. 


7. Daten 








7.1. Datenmodell 
.2. Eingabedaten 


Tabelle 2, Nr.5.1. 
Tabelle 2, Nr. 5.2. 


Tabelle 2, Nr. 5.3. 


Tabelle 2, Nr. 5.4. 
Tabelle 2, Nr. 5.5. 


Es ist zulässig, für die Programme eines Programmsy- 
stems selbständige Programmbeschreibungen zu er- 
arbeiten und in der Programmbeschreibung für das 
Gesamtsystem (Punkte 5.1. und 5.2.) auf die Pro- 
grammbeschreibungen der Einzelprogramme Bezug 
zu nehmen. 

Anmerkung: 

Diese Verfahrensweise ist zweckmäßig bei der Doku- 
mentation von Programmsystemen mit verteilter Ver- 
arbeitung, deren Teile auf verschiedener Technik bzw. 
unter verschiedenen Betriebssystemen ablaufen. 









7.3. Ausgabedaten 










. Temporäre Dateien 
. Interne Daten 





4. DOKUMENTATION VON 
SOFTWARE-ANWENDUNGSSYSTEMEN 


4.1. Inhalt der Dokumentation 

Die Dokumentation eines Software-Anwendungssy- 
stems muß alle Informationen beinhalten, die erfor- 
derlich sind, um das Software-Anwendungssystem zu 
betreiben und weiterzuentwickeln. Die Dokumentation 
hat insbesondere alle am Prozeß der Anwendung Be- 
teiligten eindeutig über die von ihnen dabei wahrzu- 
nehmenden Aufgaben zu instruieren. 

Die Dokumentation des Software-Anwendungssy- 
stems umfaßt folgende Tejle: 
1. Beschreibung der Prdrammbasis 

2. Beschreibung der Datenbasis 

3. Beschreibung des organisatorischen Systems 


3.1. Globale Beschreibung des organisatorischen Sy-. 


stems 

3.2. Beschreibung der Organisation im Bereich der 
fachlichen Anwendung 

3.3. Beschreibung der Organisation im Rechenzen- 
trum 

4. Beschreibung des technischen Systems 


Zu allgemeinen Forderungen und zur äußeren Form 
siehe Abschnitt 2. 


4.2. Anforderungen an die Dokumentationsteile 
Beschreibung der Programmbasis 

Die Beschreibung muß das eingesetzte Programm 
bzw. Programmsystem eindeutig und vollständig cha- 
rakterisieren. 

Es ist zulässig, hierfür auf eine Dokumentation gemäß 
Abschnitt 3 zu verweisen und diese entsprechend den 
vorgenommenen Anpassungen zu ergänzen bzw. zu 
konkretisieren. 

Beschreibung der Datenbasis 

Die Beschreibung muß die Datenbasis des Software- 
Anwendungssystems (genutzte und erzeugte Daten- 
fonds) eindeutig darstellen. 

Es ist zulässig, hierfür auf eine Dokumentation gemäß 
Abschnitt 3 zu verweisen, wobei diese Dokumentation 
entsprechend der Spezifik des Anwendungsfalles zu 
präzisieren bzw. zu ergänzen ist. 

Die zur Anwendung kommenden Schlüsselsysteme 
müssen in der Beschreibung enthalten sein. 
Weiterhin müssen in der Beschreibung Muster bzw. 
Abbildungen von allen Vordrucken enthalten sein, die 
zur Anwendung kommen. 

Allgemeine Beschreibung 
desorganisatorischen Systems 

Angabe aller notwendigen Funktionen/Arbeitsgänge 
mit ihren logischen und zeitlichen Zusammenhängen, 
sowie ihrer Terminisierung und Zuordnung zu Verant- 
wortungsbereichen. 

In dieser Teildokumentation sind in Verbindung mit 
den beiden folgenden Dokumentationen die erforderli- 
chen Regelungen zur Gewährleistung von Ordnung, 
Sicherheit und Geheimnisschutz darzustellen. 
Beschreibung der Organisation 

im Bereich der fachlichen Anwendung 
Zusammenstellung der Regelungen, die den organisa- 
torischen Ablauf des Software-Anwendungssystems 
festlegen. 

Zusammenstellung der Arbeitsgangbeschreibungen 
für alle notwendigen Arbeitsgänge. 

Diese Beschreibungen müssen eindeutige und voll- 
ständige Handlungsvorschriften für die Bearbeitung 
der jeweiligen Aufgabe beinhalten. Weiterhin haben 
diese Beschreibungen der Spezifik des Arbeitsganges 
Rechnung zu tragen, indem Ausfüll-, Bedien- oder Aus- 
wertungsvorschriften, sowie Fehlernachrichten und 
deren Behandlung angegeben werden. 

Bei diesen Arbeitsgängen verwendete Vordrucke sind 
als Muster/Abbildungen an geeigneter Stelle mit ein- 
zufügen. 

Es ist zulässig, auf andere Unterlagen gemäß Ab- 
schnitt 3 oder 4 zu verweisen, sofern eine praktische 
Arbeitsweise gewährleistet wird. 

Beschreibung der Organisation 

im Rechenzentrum 

Es ist die spezielle Technologie und Organisation für 
die rechentechnische Abarbeitung des Software-An- 
wendungssystems darzustellen. Form und Umfang 
dieser Beschreibung werden nicht in diesem Standard 
geregelt. Essind die Regelungen der konkreten rechen- 
technischen Einrichtung, z.B. Werkstandards oder 
andere betriebliche Festlegungen, anzuwenden. 
Beschreibung destechnischen Systems 
Angabe der zum Software-Anwendungssystem gehö- 
renden technischen Geräte, ihrer Ausstattung und ih- 
res Standortes, sowie der benutzten technischen Ver- 
bindungen. 
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5. VORDRUCK 


Deskriptoren: 










Aufgabe: 





Gerätebedarf: 


Programmgröße 


Programmbedarf: 





Sprachen: 






Sprachumfang: 







Anzahl der Anweisungen: 






Übersetzer: 


Bild 1 Vordruck PKD, Vorderseite 
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Betriebsa rten: 


Be- Verwen- Daten- Speicher- Dateior- | Zugriffs- 
zeichnung dungszweck trägerart bedarf ganisation art 


Konventionen: 


| Zuständigkeiten: 


Unterlagen: 


‚Installierungen: 


Preise/Kosten: 





Bild 2 Vordruck PKD, Rückseite 
Technische Ausführung: Format A4, beidseitiger Druck, Kopf bei Kopf, 70g/m? 
Bestellnummer beim Vordruckverlag Spremberg 785/01 
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Hinweise 


Mit ST RGW 1626-79, ST RGW 2092-80, ST RGW 2093-80, 
STRGW 2094-80, ST RGW 2095-80, ST RGW 2096-80, und 

ST RGW 2097-80 besteht Übereinstimmung hinsichtlich aller 
verbindlichen Festlegungen. 

Gegenüber diesen Standards wurden im vorliegenden Stan- 
dard die „Dokumente für die Begleitung von Programmen“ 
und die „Anwenderdokumente“ wesentlich präzisiert und zur 
„Anwenderdokumentation” zusammengefaßt. 

In Übereinstimmung mit den zulässigen Freiheitsgraden des 
ST RGW 1626-79 wurden die dortige „Programmbeschrei- 


bung“ und der „Programmtext in der Queljsprache“ zur „Pro- 
grammbeschreibung” zusammengefaßt. 

Bezüglich der „Dokumentation von Software-Anwendungs- 
systemen” geht der vorliegende Standard über die genann- 
ten Standards hinaus. ; 

Im vorliegenden Standard ist auf folgende Standards Bezug 
genommen: 

TGL 22451; TGL 36480 

Programmtext in der Quellsprache siehe TGL 39342 

Für die Beschreibung von Daten wird die „Aktualisierung und 
Ergänzung der Rahmenmethodik der DVP von 1976 — Metho- 
discher Leitfaden” empfohlen. 


